Inside Macintosh: QuickDraw GX Printing /

Chapter 3 - Page Formatting and Dialog Box Customization / Page Formatting and Dialog Box Customization Reference

Application-Defined Functions / Message Override Functions for Customizing QuickDraw GX Dialog Boxes

GXParsePageRange

QuickDraw GX sends the gxParsePageRange message when the user selects a range of pages for printing. You can install an override function for the gxParsePageRange message to modify or validate the page range. Your override function must match the following formal declaration:

OSErr GXParsePageRange (StringPtr fromString, StringPtr toString,
                        gxParsePageRangeResult *result);

fromString

A pointer to the string representation of the From page.

toString

A pointer to the string representation of the To page.

result

On return, a value that specifies the result code for the range parsing. The constants for this value are given in the section "The Panel Setup Structure" on page 3-101.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

QuickDraw GX sends the gxParsePageRange message to validate that a page range entered by the user is appropriate for the print job.

The default implementation of this message adds the standard printing panels and interface and then displays the dialog box.

You usually override this message to customize the dialog box by adding panels using the GXSetupDialogPanel function.

SPECIAL CONSIDERATIONS

You rarely need to send the gxParsePageRange message yourself.

You must forward the gxParsePageRange message to other message handlers.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help